// 版权所有2010 Go作者。保留所有权利。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// 包mime实现了mime规范的一部分。
package mime

import (
	"fmt"
	"sort"
	"strings"
	"sync"
)

var (
	mimeTypes      sync.Map // 映射[string]字符串；“.Z”=>“应用程序/x压缩”
	mimeTypesLower sync.Map // map[string]字符串；“.z”=>“应用程序/x压缩”

	// 扩展名从MIME类型映射到小写文件列表
	// 扩展名：“image/jpeg”=>[“.jpg”、“.jpeg”]
	extensionsMu sync.Mutex // 保护扩展名上的存储（但不加载）。
	extensions   sync.Map   // map[string][]string；切片值仅为附加值。
)

func clearSyncMap(m *sync.Map) {
	m.Range(func(k, _ any) bool {
		m.Delete(k)
		return true
	})
}

// setMimeTypes由initMime的非测试路径和测试使用。
func setMimeTypes(lowerExt, mixExt map[string]string) {
	clearSyncMap(&mimeTypes)
	clearSyncMap(&mimeTypesLower)
	clearSyncMap(&extensions)

	for k, v := range lowerExt {
		mimeTypesLower.Store(k, v)
	}
	for k, v := range mixExt {
		mimeTypes.Store(k, v)
	}

	extensionsMu.Lock()
	defer extensionsMu.Unlock()
	for k, v := range lowerExt {
		justType, _, err := ParseMediaType(v)
		if err != nil {
			panic(err)
		}
		var exts []string
		if ei, ok := extensions.Load(justType); ok {
			exts = ei.([]string)
		}
		extensions.Store(justType, append(exts, k))
	}
}

var builtinTypesLower = map[string]string{
	".avif": "image/avif",
	".css":  "text/css; charset=utf-8",
	".gif":  "image/gif",
	".htm":  "text/html; charset=utf-8",
	".html": "text/html; charset=utf-8",
	".jpeg": "image/jpeg",
	".jpg":  "image/jpeg",
	".js":   "text/javascript; charset=utf-8",
	".json": "application/json",
	".mjs":  "text/javascript; charset=utf-8",
	".pdf":  "application/pdf",
	".png":  "image/png",
	".svg":  "image/svg+xml",
	".wasm": "application/wasm",
	".webp": "image/webp",
	".xml":  "text/xml; charset=utf-8",
}

var once sync.Once // MIME 

var testInitMime, osInitMime func()

func initMime() {
	if fn := testInitMime; fn != nil {
		fn()
	} else {
		setMimeTypes(builtinTypesLower, builtinTypesLower)
		osInitMime()
	}
}

// TypeByExtension返回与文件扩展名ext关联的MIME类型。
// 扩展名ext应以前导点开头，如“.html”中所示。
// 当ext没有关联的类型时，TypeByExtension返回“”。
// 
// 首先查找区分大小写的扩展，然后查找不区分大小写的扩展。
// 
// 内置表很小，但在unix上，它由本地
// 系统的MIME信息数据库或MIME扩充。键入一个或多个文件名：
// 
// /usr/local/share/mime/globs2 
// /usr/share/mime/globs2 
// etc/apache2/mime。输入
// etc/apache/mime。类型
// 
// 在Windows上，MIME类型从注册表中提取。默认情况下，文本类型的字符集参数设置为“utf-8”。
func TypeByExtension(ext string) string {
	once.Do(initMime)

	// 区分大小写的查找。
	if v, ok := mimeTypes.Load(ext); ok {
		return v.(string)
	}

	// 不区分大小写的查找。
	// 乐观地假设一个简短的ASCII扩展名，在这种情况下不需要分配。
	var buf [10]byte
	lower := buf[:0]
	const utf8RuneSelf = 0x80 // 来自utf8软件包，但不导入。
	for i := 0; i < len(ext); i++ {
		c := ext[i]
		if c >= utf8RuneSelf {
			// 慢路径。
			si, _ := mimeTypesLower.Load(strings.ToLower(ext))
			s, _ := si.(string)
			return s
		}
		if 'A' <= c && c <= 'Z' {
			lower = append(lower, c+('a'-'A'))
		} else {
			lower = append(lower, c)
		}
	}
	si, _ := mimeTypesLower.Load(string(lower))
	s, _ := si.(string)
	return s
}

// ExtensionsByType返回已知与MIME关联的扩展
// type类型。返回的扩展名将以一个前导点开头，如
// /“.html”。当typ没有关联的扩展时，ExtensionsByType返回一个
// nil切片。
func ExtensionsByType(typ string) ([]string, error) {
	justType, _, err := ParseMediaType(typ)
	if err != nil {
		return nil, err
	}

	once.Do(initMime)
	s, ok := extensions.Load(justType)
	if !ok {
		return nil, nil
	}
	ret := append([]string(nil), s.([]string)...)
	sort.Strings(ret)
	return ret, nil
}

// AddExtensionType将与
// 扩展ext关联的MIME类型设置为typ。扩展名应该以
// 开头，如“.html”中的前导点。
func AddExtensionType(ext, typ string) error {
	if !strings.HasPrefix(ext, ".") {
		return fmt.Errorf("mime: extension %q missing leading dot", ext)
	}
	once.Do(initMime)
	return setExtensionType(ext, typ)
}

func setExtensionType(extension, mimeType string) error {
	justType, param, err := ParseMediaType(mimeType)
	if err != nil {
		return err
	}
	if strings.HasPrefix(mimeType, "text/") && param["charset"] == "" {
		param["charset"] = "utf-8"
		mimeType = FormatMediaType(mimeType, param)
	}
	extLower := strings.ToLower(extension)

	mimeTypes.Store(extension, mimeType)
	mimeTypesLower.Store(extLower, mimeType)

	extensionsMu.Lock()
	defer extensionsMu.Unlock()
	var exts []string
	if ei, ok := extensions.Load(justType); ok {
		exts = ei.([]string)
	}
	for _, v := range exts {
		if v == extLower {
			return nil
		}
	}
	extensions.Store(justType, append(exts, extLower))
	return nil
}
